feat(sdk): add an E2B client to the Desktop SDKs by devin-ai-integration[bot] · Pull Request #1784 · e2b-dev/E2B

devin-ai-integration · 2026-08-27T21:16:06Z

Summary

Same change as #1783 (which this is stacked on), for @e2b/desktop and e2b-desktop: an E2B client that binds the connection configuration explicitly instead of reading it from the environment. packages/js-sdk and packages/python-sdk are untouched — the binding is local to the package and only uses the existing ClientFactory class state (boundOpts / _bound_api_params) the Desktop Sandbox already inherits.

import { E2B } from '@e2b/desktop'

const desktop = await new E2B({ apiKey, domain }).Sandbox.create()
await desktop.stream.start()

from e2b_desktop import E2B

desktop = E2B(api_key=..., domain=...).Sandbox.create()
desktop.stream.start()

// src/client.ts — Desktop Sandbox bound locally…
this.Sandbox = class extends Sandbox {
  protected static override readonly boundOpts = boundOpts
}
// …the rest delegated to the core client.
const core = new CoreE2B(boundOpts)
this.Volume = core.Volume
this.Template = core.Template
this.Secret = core.Secret

Python mirrors it with the local _bind(cls, api_params) helper. Options are copied (nested header maps snapshotted, signal dropped), precedence stays per-call > client > env, undefined/None doesn't clear a bound value, and clients stay isolated from each other and from the top-level exports.

The new JS suite mocks the API with a local node:http server, so it's excluded from the workerd leg (Node/bun/deno keep running it); desktop.startStream-style calls into envd are stubbed since only the API calls carry the bound config.

Link to Devin session: https://app.devin.ai/sessions/ec1af68649fd4880a1cb27cb51d819e9
Open in Devin Desktop: https://app.devin.ai/desktop/session/ec1af68649fd4880a1cb27cb51d819e9?variant=devin
Requested by: @mishushakov

devin-ai-integration · 2026-08-27T21:16:09Z

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

Disable automatic comment, CI, and merge conflict monitoring

changeset-bot · 2026-08-27T21:16:12Z

🦋 Changeset detected

Latest commit: 3d5ad37

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@e2b/desktop	Minor
@e2b/desktop-python	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-08-27T21:17:19Z

Package Artifacts

Built from e696aeb. Download artifacts from this workflow run.

JS SDK (e2b@2.46.2-devin-1787774001-desktop-e2b-client.0):

npm install ./e2b-2.46.2-devin-1787774001-desktop-e2b-client.0.tgz

CLI (@e2b/cli@2.18.1-devin-1787774001-desktop-e2b-client.0):

npm install ./e2b-cli-2.18.1-devin-1787774001-desktop-e2b-client.0.tgz

Code Interpreter JS SDK (@e2b/code-interpreter@2.7.3-devin-1787774001-desktop-e2b-client.0):

npm install ./e2b-code-interpreter-2.7.3-devin-1787774001-desktop-e2b-client.0.tgz

Desktop JS SDK (@e2b/desktop@2.3.4-devin-1787774001-desktop-e2b-client.0):

npm install ./e2b-desktop-2.3.4-devin-1787774001-desktop-e2b-client.0.tgz

Python SDK (e2b==2.46.1+devin.1787774001.desktop.e2b.client):

pip install ./e2b-2.46.1+devin.1787774001.desktop.e2b.client-py3-none-any.whl

Code Interpreter Python SDK (e2b-code-interpreter==2.9.2+devin.1787774001.desktop.e2b.client):

pip install ./e2b_code_interpreter-2.9.2+devin.1787774001.desktop.e2b.client-py3-none-any.whl

Desktop Python SDK (e2b-desktop==2.4.4+devin.1787774001.desktop.e2b.client):

pip install ./e2b_desktop-2.4.4+devin.1787774001.desktop.e2b.client-py3-none-any.whl

devin-ai-integration

TASTE.md review

Checked the diff against the SDK design principles in TASTE.md, with emphasis on the rules this change can plausibly break: cross-language parity (T-1, T-2), option-type naming and shape (T-10, T-22, T-23), JS data-vs-class and export hygiene (T-19, T-54), config resolution (T-49, T-51), and docstrings (T-69–T-72).

Overall the desktop client is a faithful mirror of the Code Interpreter client from the base PR: options are copied rather than aliased (T-51), the whole connection surface is bound rather than a { apiKey, domain } subset (T-6), signal is deliberately excluded from the bound options (T-46), and both classes and their members carry real JSDoc/docstrings with examples (T-69, T-70).

2 violations, both inline.

Not tied to a specific changed line:

packages/desktop-python/pyproject.toml raises the floor to e2b>=2.46.1, but ClientFactory._with_params — the API this client is built on — is added by the base PR and is not in 2.46.1. The floor should be the first release that actually ships it, otherwise a user resolving to 2.46.1 gets an AttributeError at E2B(...) construction time.
packages/desktop-python/e2b_desktop/__init__.py computes __all__ from e2b.__all__ at import time. It satisfies T-54 at runtime, but the public surface is no longer greppable in the file — worth a comment pointing at the core __all__ if this pattern stays.

devin-ai-integration · 2026-08-27T21:19:27Z

@@ -1,3 +1,4 @@
 export * from 'e2b'

+export { E2B, type E2BClientOpts } from './client'


T-54 — one flat entry point per package, and in JS "runtime values use export and type-only names use export type — never mixed". This line mixes the runtime class E2B with the type-only E2BClientOpts in a single export statement; split them so the type-only name goes through export type:

Suggested change

export { E2B, type E2BClientOpts } from './client'

export { E2B } from './client'

export type { E2BClientOpts } from './client'

Done — split into export { E2B } and export type { E2BClientOpts } (1d48bf3).

devin-ai-integration · 2026-08-27T21:19:28Z

+from e2b_desktop.main import Sandbox
+
+
+class E2BClientParams(ApiParams, total=False):


T-22 / T-1 — "Option types use the Opts suffix in both languages", and the JS and Python surfaces "mirror each other 1:1 in names", differing only by language idiom (camelCase ↔ snake_case, T-1a). Opts → Params is not a language idiom, so the exported option type here should be E2BClientOpts, matching packages/desktop-js/src/client.ts:

class E2BClientOpts(ApiParams, total=False): """Options bound to an :class:`E2B` client, ..."""

No suggestion block since the rename also touches the E2BClientParams re-export in e2b_desktop/__init__.py (and the same name is introduced for the core and Code Interpreter clients in the base PR) — worth settling in the base PR and mirroring here, so the three packages don't ship two spellings of the same type.

Keeping E2BClientParams: it mirrors the name the released core e2b package already uses for this type, and the Opts rename would have to change the core SDK, which is out of scope here (this PR leaves packages/js-sdk/packages/python-sdk untouched). Can do the parity rename across core + both downstream packages in a follow-up. Also in 1d48bf3: the e2b>=2.46.1 floor is reverted (nothing new is needed from the core anymore) and the computed __all__ is gone, so the package's surface is plain imports again.

mishushakov · 2026-08-28T13:49:52Z

can you implement taste suggestions

claude

Code review found no issues

No high-confidence issues detected in this change.

Co-Authored-By: mish@e2b.dev <mish@e2b.dev>

…ntouched Co-Authored-By: mish@e2b.dev <mish@e2b.dev>

Split the type-only export out of the runtime one, import ApiParams from the e2b entry point instead of its module, and drop the computed __all__. Co-Authored-By: mish@e2b.dev <mish@e2b.dev>

The client imports E2B and ApiParams from the e2b entry point, both of which first shipped in 2.44.0. Co-Authored-By: mish@e2b.dev <mish@e2b.dev>

devin-ai-integration Bot assigned mishushakov Aug 27, 2026

cla-bot Bot added the cla-signed label Aug 27, 2026

This was referenced Aug 27, 2026

feat(sdk): add E2B client to the downstream SDK packages #1772

Closed

feat(sdk): add an E2B client to the Code Interpreter SDKs #1783

Open

devin-ai-integration Bot commented Aug 27, 2026

View reviewed changes

devin-ai-integration Bot force-pushed the devin/1787774001-desktop-e2b-client branch 2 times, most recently from 5632182 to 95025df Compare August 27, 2026 21:33

devin-ai-integration Bot force-pushed the devin/1787774001-desktop-e2b-client branch from 95025df to 1d48bf3 Compare August 28, 2026 13:52

mishushakov approved these changes Aug 28, 2026

View reviewed changes

mishushakov marked this pull request as ready for review August 28, 2026 14:24

claude Bot reviewed Aug 28, 2026

View reviewed changes

devin-ai-integration Bot and others added 4 commits August 28, 2026 14:46

feat(sdk): add an E2B client to the Desktop SDKs

9334133

Co-Authored-By: mish@e2b.dev <mish@e2b.dev>

refactor(sdk): bind the Desktop client locally, leave the core SDKs u…

e2db28e

…ntouched Co-Authored-By: mish@e2b.dev <mish@e2b.dev>

refactor(sdk): tidy the Desktop client exports per TASTE

45c797e

Split the type-only export out of the runtime one, import ApiParams from the e2b entry point instead of its module, and drop the computed __all__. Co-Authored-By: mish@e2b.dev <mish@e2b.dev>

fix(sdk): require e2b>=2.44.0 for the Desktop client

3d5ad37

The client imports E2B and ApiParams from the e2b entry point, both of which first shipped in 2.44.0. Co-Authored-By: mish@e2b.dev <mish@e2b.dev>

devin-ai-integration Bot force-pushed the devin/1787774001-desktop-e2b-client branch from 1d48bf3 to 3d5ad37 Compare August 28, 2026 14:46

Navigation Menu

Uh oh!

feat(sdk): add an E2B client to the Desktop SDKs - #1784

feat(sdk): add an E2B client to the Desktop SDKs#1784
devin-ai-integration[bot] wants to merge 4 commits into
devin/1787774000-code-interpreter-e2b-clientfrom
devin/1787774001-desktop-e2b-client

devin-ai-integration Bot commented Aug 27, 2026 •

edited

Loading

Uh oh!

devin-ai-integration Bot commented Aug 27, 2026

Uh oh!

changeset-bot Bot commented Aug 27, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 27, 2026 •

edited

Loading

Uh oh!

devin-ai-integration Bot left a comment

Uh oh!

devin-ai-integration Bot Aug 27, 2026

Uh oh!

devin-ai-integration Bot Aug 28, 2026

Uh oh!

devin-ai-integration Bot Aug 27, 2026

Uh oh!

devin-ai-integration Bot Aug 28, 2026

Uh oh!

mishushakov commented Aug 28, 2026

Uh oh!

claude Bot left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

		@@ -1,3 +1,4 @@
		export * from 'e2b'

		export { E2B, type E2BClientOpts } from './client'

	export { E2B, type E2BClientOpts } from './client'
	export { E2B } from './client'
	export type { E2BClientOpts } from './client'

		from e2b_desktop.main import Sandbox


		class E2BClientParams(ApiParams, total=False):

Uh oh!

Conversation

devin-ai-integration Bot commented Aug 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

devin-ai-integration Bot commented Aug 27, 2026

🤖 Devin AI Engineer

Uh oh!

changeset-bot Bot commented Aug 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions Bot commented Aug 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Package Artifacts

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

TASTE.md review

Uh oh!

devin-ai-integration Bot Aug 27, 2026

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot Aug 28, 2026

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot Aug 27, 2026

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot Aug 28, 2026

Choose a reason for hiding this comment

Uh oh!

mishushakov commented Aug 28, 2026

Uh oh!

claude Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

devin-ai-integration Bot commented Aug 27, 2026 •

edited

Loading

changeset-bot Bot commented Aug 27, 2026 •

edited

Loading

github-actions Bot commented Aug 27, 2026 •

edited

Loading